docs: Restructure a bit

Split the overview sections off into its own "concepts part.

diff --git a/docs/reference/gtk/drawing-model.xml b/docs/reference/gtk/drawing-model.xml
index 5a4dd781df38044e86f0f63e56617f3b7cba5ad6..27cf247aefd71a46b4c28deb90ebf6e26804a551 100644 (file)
--- a/docs/reference/gtk/drawing-model.xml
+++ b/docs/reference/gtk/drawing-model.xml
@@ -203,12 +203,12 @@
       <title>Hierarchical drawing</title>
 
       <para>
-        During the Paint phase GTK receives a single ::render signal on the toplevel
-        window. The signal handler will create a snapshot object (which is a
-        helper for creating a scene graph) and emit a GtkWidget::snapshot() signal,
-        which will propagate down the widget hierarchy. This lets each widget
-        snapshot its content at the right place and time, correctly handling things
-        like partial transparencies and overlapping widgets.
+        During the Paint phase GTK receives a single #GdkSurface::render signal on
+        the toplevel surface. The signal handler will create a snapshot object
+        (which is a helper for creating a scene graph) and call the
+        #GtkWidget::snapshot() vfunc, which will propagate down the widget hierarchy. 
+        This lets each widget snapshot its content at the right place and time,
+        correctly handling things like partial transparencies and overlapping widgets.
       </para>
 
       <para>
@@ -217,7 +217,7 @@
         the render nodes of children, and grandchildren, and so on), and will reuse
         that node during the Paint phase. Invalidating a widget (by calling
         gtk_widget_queue_draw()) discards the cached render node, forcing the widget
-        to regenerate it the next time it needs to handle a ::snapshot.
+        to regenerate it the next time it needs to produce a snapshot.
       </para>
     </refsect2>
 

diff --git a/docs/reference/gtk/gtk4-docs.xml b/docs/reference/gtk/gtk4-docs.xml
index cca756c355a5e2c06290e3f01287c242766c3bda..a01508c54d6624487ae5e0087ddcfa07b1fc37ce 100644 (file)
--- a/docs/reference/gtk/gtk4-docs.xml
+++ b/docs/reference/gtk/gtk4-docs.xml
@@ -19,11 +19,15 @@
   </bookinfo>
 
   <part id="gtk">
-    <title>GTK Overview</title>
+    <title>Introduction</title>
     <xi:include href="overview.xml"/>
     <xi:include href="xml/getting_started.xml"/>
     <xi:include href="resources.xml" />
     <xi:include href="xml/question_index.xml" />
+  </part>
+
+  <part id="concepts">
+    <title>GTK Concepts</title>
     <xi:include href="xml/drawing-model.xml" />
     <xi:include href="xml/input-handling.xml" />
     <xi:include href="xml/actions.xml" />